home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 4 / BBS in a Box - Macintosh - Volume IV (January 1992) (BBS in a Box).iso / Files / Tele / P / Power.cpt / Power / READ ME! / READ ME!
Encoding:
Text File  |  1988-11-19  |  16.0 KB  |  325 lines  |  [APPL/LETR]

  1.  
  2. ***************************************************************************
  3. ***************************************************************************
  4. These procedures are the creation of Stephen Sayer  and  are  meant  to  be
  5. distributed  free of charge except where normal online charges would apply.
  6. You guys all know what this means. Don't sell my procedures  to  anyone  or
  7. otherwise  compromise my rights to these procedures. Future versions may be
  8. released as shareware and a registration fee will then be required for user
  9. support and upgrades.
  10. ***************************************************************************
  11. ***************************************************************************
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                 Welcome to Power!
  19.  
  20.  
  21.         This  is  an  updated  release version (1.0) of Power. There may be
  22. a couple of bugs, but I tested it enough to release it so here you go. See
  23. the 1.0 release notes at the end of these docs. I will need  to  hear  feed
  24. back  from  you to improve Power, so, drop me a line. E-Mail is fine too.
  25. I'm on GEnie, s.sayer1, MTS:UB at UofM,  Sephen Sayer, and  on several
  26. different bulletin boards across the Telenet network. I may even be on your
  27. local BBS! You can also  find  me  very regularly  on  the MacTechnics  BBS
  28. in  Ann  Arbor,  MI,  if  you  are  a member of that fine organization.
  29.  
  30. You should have the following files in the Power folder:
  31.  
  32. 1200                      10180  RSE1 SCOT  Mon, Nov  7, 1988
  33. 2400                      10180  RSE1 SCOT  Mon, Nov  7, 1988
  34. 300                       10180  RSE1 SCOT  Mon, Nov  7, 1988
  35. A.PROC                     1243  RREP SCOT  Sun, Nov 13, 1988
  36. AZPHO.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  37. C.PROC                     1089  RREP SCOT  Sun, Nov 13, 1988
  38. CACOL.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  39. CAGLE.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  40. CALAN.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  41. CAOAK.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  42. CAPAL.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  43. CASAD.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  44. CASAN.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  45. CASFA.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  46. CASJO.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  47. CC.PROC                     507  RREP SCOT  Sun, Nov 13, 1988
  48. CG1.PROC                   1097  RREP SCOT  Sun, Nov 13, 1988
  49. CG2.PROC                   1100  RREP SCOT  Sun, Nov 13, 1988
  50. CODEN.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  51. Configure Power.PROC       1857  RREP SCOT  Mon, Nov 14, 1988
  52. CP.PROC                    2134  RREP SCOT  Sun, Nov 13, 1988
  53. CTHAR.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  54. DC.PROC                    1107  RREP SCOT  Sun, Nov 13, 1988
  55. DCWAS.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  56. FLMIA.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  57. FLTAM.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  58. GAATL.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  59. GC.PROC                    2164  RREP SCOT  Sun, Nov 13, 1988
  60. GT.PROC                     890  RREP SCOT  Sun, Nov 13, 1988
  61. HU.PROC                     607  RREP SCOT  Mon, Nov 14, 1988
  62. ILCHI.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  63. MABOS.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  64. MIDET.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  65. MNMIN.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  66. MOKAN.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  67. MOSLO.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  68. NCRTP.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  69. NJNEW                       652  TEXT McSk  Sun, Nov 13, 1988
  70. NJNEW.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  71. NYNYO.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  72. OHCLV.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  73. ORPOR.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  74. PAPHI.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  75. PM                         7650  RRM1 SCOT  Sun, Nov 13, 1988
  76. READ ME!                  22170  APPL LETR  Mon, Nov 14, 1988
  77. TXDAL.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  78. TXHOU.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  79. UTSLC.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  80. WASEA.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  81. WIMIL.PROC                  488  RREP SCOT  Sun, Nov 13, 1988
  82.  
  83. You should also have the M folder in the Power folder.
  84.  
  85. In the M folder you will find these macro key files:
  86.  
  87. NJNEW       7650  RRM1 SCOT  Sun, Nov 13, 1988
  88. PHS         7650  RRM1 SCOT  Sun, Nov 13, 1988
  89. PHS2        7650  RRM1 SCOT  Sun, Nov 13, 1988
  90. PLS         7650  RRM1 SCOT  Sun, Nov 13, 1988
  91. PLS2        7650  RRM1 SCOT  Sun, Nov 13, 1988
  92. PMS         7650  RRM1 SCOT  Sun, Nov 13, 1988
  93. PMS2        7650  RRM1 SCOT  Sun, Nov 13, 1988
  94.  
  95.  
  96.         Anyway here's how to Power up. First make sure  that  you  put  the
  97. Power  folder  in the root directory of your HFS disk. Sorry about that but
  98. Red Ryder has serious problems with Path/File names that are too  long  for
  99. it  to  digest  properly  (urp!).  Second make sure all of the Macro files,
  100. except PM, are in a folder within the Power folder titled M (that's  right,
  101. just  M,  no  spaces,  no anything else, just M!). Now your ready to start.
  102. First initiate the Configure Power.PROC from within  Red  Ryder.  You  will
  103. need to enter your PC Pursuit ID# & Password, the dialing commands for 300,
  104. 1200, and 2400 baud access numbers for your area,  a  password  to  use  to
  105. protect  Power  from  unauthorized  use, and then you will need to find the
  106. Power folder. As soon as  the  selection  box  to  find  the  Power  folder
  107. appears, it will already be in the Power folder, so you will merely need to
  108. click Select (but check just to make sure it is in the right place).
  109.  
  110.         Upon completion of the Configure Power.PROC, you  might  note  that
  111. there is a new procedure which has been compiled called Power.PROC. This is
  112. an encrypted Red Ryder procedure file, so it should be fairly tamper proof.
  113. If  you  find  that  you  have made a mistake in entry during the Configure
  114. Power.PROC, you should first delete  the  Power.PROC  file  then  intitiate
  115. Configure  Power.PROC  again. You will need to enter all of the information
  116. again of course. You should also do this  if  you  move  Power  to  another
  117. location on your disk.
  118.  
  119.         Configure  Power.PROC  did  one  other thing also. It loaded the PM
  120. macro file which is what you will use  to  start  Power.  There  are  three
  121. buttons  in  this  macro  set. You will need to attach them to their proper
  122. procedure files. Here's how...
  123.  
  124.         Select Edit Macro Keys from the Edit menu. Click  the  Edit  button
  125. then  the Get Procedure File button. Then select the Power.PROC file in the
  126. selection box. Next, click Save then select the #4 Macro in the 1st set and
  127. choose  Edit  again.  This  time  'Get  Procedure  File' C.PROC and 'Save.'
  128. Similarly edit the #9 macro in the 1st set. Now click  Done  and  save  the
  129. Macros  to  the  Power  folder  as PM. Go ahead and replace the old PM (Red
  130. Ryder will ask you if that's what you want to do).
  131.  
  132.         Now that your linked to the Power.PROC, you're ready to  load  some
  133. of  the  PC  Pursuit cities into the arsenal. I have created some macro key
  134. files that will automatically attempt to connect with a remote  PC  Pursuit
  135. city. You will need to do a little work first though.
  136.  
  137.         In the M folder, you will find the macro files...
  138.                         
  139.                 NJNEW            (for  BBSs  in the
  140. NJNEW area: a template...)
  141.                 PHS             (High Speed/2400 macros, set 1)
  142.                 PHS2            (High Speed/2400 macros, set 2)
  143.                 PLS             (Low Speed/300 macros, set 1)
  144.                 PLS2            (Low Speed/300 macros, set 2)
  145.                 PMS             (Medium Speed/1200 macros, set 1)
  146.                 PMS2            (Medium Speed/1200 macros, set 2)
  147.  
  148.         These files have buttons in place for their intended functions. You
  149. will  have  to link them to the .PROC files they activate. Load each one in
  150. turn, while in Red Ryder and Edit all of the buttons that are present.  The
  151. macro  buttons should be assigned to the following .PROC files by using Get
  152. Procedure File to locate the procedure for that button  as  illustrated  by
  153. this list.
  154.  
  155.                 BUTTON  =>      .PROC FILE
  156.                 ------          ----------
  157.                 Call Pursuit    Power.PROC
  158.                 Capture Text    C.PROC
  159.                 End Capture     CC.PROC
  160.                 Pursuit BBS     * no procedure file necessary *
  161.  
  162.         The City buttons are easier to explain.
  163.  
  164. example:        BUTTON  =>      .PROC FILE
  165.                 ------          ----------
  166.                 GAATL:404       GAATL.PROC
  167.                 MABOS:617       MABOS.PROC
  168.                 NYNYO:212:718   NYNYO.PROC
  169.  
  170.         Do  you  see a pattern emerging here? I thought you would. Granted,
  171. there are a lot of buttons on some of those macro files,  but  it's  really
  172. easy to do once you get going. Also if you don't use Pursuit at some speed,
  173. for example 300 baud, you don't need to link the macro files for that speed
  174. if your not going to use them (in our example the files PLS & PLS2 as shown
  175. above). You don't even have to link the city's that you don't use, but I'll
  176. bet  you'll  find  yourself  calling a lot more places once you start using
  177. Power. So load up all you can handle, remembering that I  did  the  hardest
  178. part of this for you, and you'll get through it with few, if any, problems.
  179.  
  180.         Be  sure to save all of these macro files with their original names
  181. in the M folder (except PM, as noted),or Power will not work properly.
  182.  
  183.         Now, at long last, you're ready to begin.  Load  the    PM    macro
  184. file again.  Now    press    the  Call  Pursuit macro button and enter your
  185. password if you decided to use one. You will  be   prompted    to    choose
  186. what  speed  to connect at, then you will be connected. A note to 2400 baud
  187. users: You know how  weird  some  of  the  2400  baud  access  #'s  can  be
  188. sometimes,  so  when  you see    the    "CONNECT   2400"  message from your
  189. modem you may need to give the return key a few taps to get  things  going.
  190. Other  speeds  appear  to  work  just fine. I will continue to work on this
  191. problem.
  192.  
  193.         You  may  have noticed that there is now a new item called Power in
  194. the menu bar. Take a  look  at  the  choices.  "About..."  is  pretty  self
  195. explanatory,  "Get  Telenet"  sends  an  @  character  to return to Telenet
  196. control, "Disc. City" sends the D command  telling  Telenet  to  disconnect
  197. from  the  remote city, "Hang Up" will send HANGUP to the host then hang up
  198. the phone and exit Power, "City Group 1" & "City Group 2" will  toggle  the
  199. macro  files with the cities on them according to what speed your connected
  200. at. You will notice that there are no cities listed on the PHS2 or the PLS2
  201. macro files. These were added for future expansion if necessary.
  202.  
  203.         All  of  the  menu  commands are situation sensitive in that a menu
  204. command is only available when it is appropriate. Hang  Up  is  your  panic
  205. button  if you get into trouble. You must use the buttons though to stay in
  206. sync with their activation and deactivation. So try to avoid entering these
  207. commands manually.
  208.  
  209.         The  payoff  is  that your macro files will be loaded automatically
  210. and you won't have to sit there entering those ridiculous strings over  and
  211. over  again  manually. When you click on a city to call, the procedure will
  212. ask you how many times you would like for it to  attempt  a  connection  at
  213. whatever  city  was selected (it just occured to me to show the name of the
  214. city in that dialog box, look for that in the  future  versions).  It  will
  215. then  go  about  it's  task  until  either  connected  or  it has tried the
  216. specified number of times (or if an error condition exists). When it  beeps
  217. once  it  means  that a CONNECTED message was received and you are ready to
  218. dial out. If it beeps twice, no CONNECTED message was received or there  is
  219. an  error condition. In any case don't panic if it beeps twice. Just select
  220. the city again, or another city, and try some more.
  221.  
  222.         You will later want to add dialing commands for  your  regular  BBS
  223. contacts  in  different  cities  by creating macro files with the template,
  224. NJNEW macro file. Just name the macro file in all caps with the name of the
  225. Pursuit  city  code,  like NJNEW. Later I may be releasing a bunch of these
  226. city macro files with the corresponding Red Ryder Host BBSs loaded  already
  227. for  those  who  have  helped  significantly  with the development of Power
  228. through beta testing or contributions.
  229.  
  230.         When it comes time to add more PC Pursuit cities you will find  the
  231. text  file  NJNEW  is  your template to do that. All you need to do is open
  232. NJNEW with a text editor of Red Ryder's preference and  then  "Save  As..."
  233. the  name of the Pursuit city, i.e. MABOS. Then swap the same name with the
  234. name NJNEW in the procedure file (remember all caps). Then close the  file,
  235. link it to the appropriate connection speed (baud rate) macro file and it's
  236. ready to use.
  237.  
  238.         That's about all I can say about this so far except that with  your
  239. help  & suggestions I will try to improve upon Power and possibly release a
  240. related procedure set, codename Ultima. This one will allow one  more  wide
  241. reaching  control  of  non  Pursuit BBSs, thus integrating your telecommun-
  242. ications atmosphere.
  243.  
  244.  
  245.         In future versions I will probably put the Capture Text &  the  End
  246. Capture  commands  in the Power menu, unless someone has strong objections.
  247. You might also notice that these two procedures  (C.PROC  &  CC.PROC)  work
  248. independently  of  Power's  other procedures, so use them with your regular
  249. array of procedures and macro keys. The two points to remember are that  C%
  250. carries  a  value that is tested by End Capture (CC.PROC) to determine if a
  251. text capture was started by Capture  Text  C.PROC,  where;  0=Capture  off,
  252. 1=Capture  on). Also the String Variable, N$, contains the name of the Host
  253. System in my procedures, so if there is a string in N$, the procedure  will
  254. first  offer  to  capture  text  as the Host System's name with the current
  255. month & day according to your Mac's setting. If you find  these  procedures
  256. useful,  wait  'til  you  see  how  great  they are for all of your regular
  257. BBS'ing!
  258.  
  259.         If you have problems, comments, questions, tips, or  just  want  to
  260. rap, get in touch...
  261.  
  262.  
  263.  
  264.         I can be snail mailed at:       Stephen Sayer
  265.                                         4764 Washtenaw #C3
  266.                                         Ann Arbor, MI 48108-1425
  267.  
  268.         I can be E-Mailed on:           GEnie, s.sayer1
  269.                                         MTS:UB, Stephen Sayer
  270.                                         EEE's BBS in New Jersey
  271.                                         MacTechnics BBS in Ann Arbor, MI
  272.  
  273.  
  274.         Thanks a lot in advance for any assistance you can offer toward the
  275. refinement and enhancement of Power. Remember you get what you pay for!
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.                         Have A Great Time!
  283.  
  284.  
  285.         Stephen Sayer aka: Electric Eye, Grinder, MiG Eater...
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293. Release Note
  294. ____________
  295.  
  296.  
  297. Upgrade note 11/19/88: version 1.0b to 1.0
  298.  
  299.  
  300.  
  301.  
  302. This copy of Power includes a bug fix that yielded a compile error when one
  303. chooses to use no password during the Configure.PROC. Thanks very much to
  304. William Marriott for pointing out this problem. This and a couple of small
  305. changes makes this version 1.0 with 1.1 to be released before the end of
  306. the year (I hope!).
  307.  
  308. I would also like to mention here that it is possible to avoid having to
  309. link the macro buttons to their procedures if you put the Power folder on a
  310. disk named New Stuff and run the configuration and subsequently the Power
  311. procedure itself from there.
  312.  
  313. Sorry about the difficulties any one had with the password thing.
  314.  
  315. If you are reading this as part of the  Power upgrade kit, or already have
  316. a copy of Power, simply replace the Configure.PROC & the CP.PROC in the
  317. Power folder with the new versions included here. You will be able to
  318. choose to use no password once these are installed.
  319.  
  320. Thanks for using Power!
  321.  
  322.  
  323. Stephen Sayer
  324.  
  325.